home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / lisp / elk-2_0.lha / elk-2.0 / contrib / zelk / Doc / installation.latex < prev    next >
LaTeX Document  |  1992-11-13  |  9.7 KB

open in: MacOS 8.1     |     Win98     |     DOS

browse contents    |     view JSON data     |     view as text


This file was processed as: LaTeX Document (document/latex).

ConfidenceProgramDetectionMatch TypeSupport
100% dexvert LaTeX Document (document/latex) magic Supported
1% dexvert Text File (text/txt) fallback Supported
100% file LaTeX document text default
99% file LaTeX document, ASCII text default
100% TrID LaTeX 2e document (with rem) default
100% checkBytes Printable ASCII default
100% perlTextCheck Likely Text (Perl) default
100% siegfried fmt/281 LaTeX (Subdocument) default
100% detectItEasy Format: plain text[LF] default (weak)



hex view
+--------+-------------------------+-------------------------+--------+--------+
|00000000| 25 20 54 68 69 73 20 69 | 73 20 61 20 6c 61 74 65 |% This i|s a late|
|00000010| 78 20 66 69 6c 65 2e 20 | 49 74 20 63 61 6e 20 62 |x file. |It can b|
|00000020| 65 20 72 65 61 64 20 61 | 73 20 69 73 20 69 66 20 |e read a|s is if |
|00000030| 6c 61 74 65 78 20 69 73 | 20 6e 6f 74 20 61 76 61 |latex is| not ava|
|00000040| 69 6c 61 62 6c 65 2e 0a | 5c 64 6f 63 75 6d 65 6e |ilable..|\documen|
|00000050| 74 73 74 79 6c 65 7b 61 | 72 74 69 63 6c 65 7d 5c |tstyle{a|rticle}\|
|00000060| 62 65 67 69 6e 7b 64 6f | 63 75 6d 65 6e 74 7d 0a |begin{do|cument}.|
|00000070| 25 5c 6e 65 77 63 6f 6d | 6d 61 6e 64 7b 5c 6b 77 |%\newcom|mand{\kw|
|00000080| 64 7d 5b 31 5d 7b 5c 76 | 62 7b 23 31 7d 7d 0a 5c |d}[1]{\v|b{#1}}.\|
|00000090| 6e 65 77 63 6f 6d 6d 61 | 6e 64 7b 5c 6b 77 64 7d |newcomma|nd{\kwd}|
|000000a0| 5b 31 5d 7b 7b 5c 74 74 | 20 23 31 7d 7d 0a 5c 70 |[1]{{\tt| #1}}.\p|
|000000b0| 61 72 69 6e 64 65 6e 74 | 20 30 70 74 20 20 20 20 |arindent| 0pt |
|000000c0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 25 6e | | %n|
|000000d0| 6f 20 69 6e 64 65 6e 74 | 20 69 6e 20 66 69 72 73 |o indent| in firs|
|000000e0| 74 20 6c 69 6e 65 20 6f | 66 20 70 61 72 61 67 72 |t line o|f paragr|
|000000f0| 61 70 68 0a 5c 70 61 72 | 73 6b 69 70 20 2e 37 65 |aph.\par|skip .7e|
|00000100| 6d 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |m | |
|00000110| 20 20 20 20 25 76 73 6b | 69 70 20 62 65 74 77 65 | %vsk|ip betwe|
|00000120| 65 6e 20 70 61 72 61 67 | 72 61 70 68 73 0a 5c 74 |en parag|raphs.\t|
|00000130| 69 74 6c 65 7b 5c 62 66 | 20 0a 20 20 20 20 20 20 |itle{\bf| . |
|00000140| 20 20 45 4c 4b 20 45 58 | 54 45 4e 53 49 4f 4e 53 | ELK EX|TENSIONS|
|00000150| 20 49 4e 53 54 41 4c 4c | 41 54 49 4f 4e 20 47 55 | INSTALL|ATION GU|
|00000160| 49 44 45 0a 7d 0a 5c 61 | 75 74 68 6f 72 7b 0a 20 |IDE.}.\a|uthor{. |
|00000170| 20 20 20 20 20 20 20 4a | 2e 50 2e 4c 65 77 69 73 | J|.P.Lewis|
|00000180| 5c 5c 0a 20 20 20 20 20 | 20 20 20 4e 45 43 20 43 |\\. | NEC C|
|00000190| 5c 26 43 20 52 65 73 65 | 61 72 63 68 5c 5c 0a 20 |\&C Rese|arch\\. |
|000001a0| 20 20 20 20 20 20 20 7a | 69 6c 6c 61 40 63 63 72 | z|illa@ccr|
|000001b0| 6c 2e 6e 6a 2e 6e 65 63 | 2e 63 6f 6d 0a 7d 0a 0a |l.nj.nec|.com.}..|
|000001c0| 5c 64 61 74 65 7b 31 32 | 20 4e 6f 76 65 6d 62 65 |\date{12| Novembe|
|000001d0| 72 20 39 32 7d 0a 0a 5c | 6d 61 6b 65 74 69 74 6c |r 92}..\|maketitl|
|000001e0| 65 0a 0a 54 68 69 73 20 | 66 69 6c 65 20 68 61 73 |e..This |file has|
|000001f0| 20 69 6e 73 74 72 75 63 | 74 69 6f 6e 73 20 66 6f | instruc|tions fo|
|00000200| 72 20 62 75 69 6c 64 69 | 6e 67 20 74 68 65 20 45 |r buildi|ng the E|
|00000210| 6c 6b 20 65 78 74 65 6e | 73 69 6f 6e 73 2e 0a 54 |lk exten|sions..T|
|00000220| 68 65 20 62 75 69 6c 64 | 69 6e 67 20 70 72 6f 63 |he build|ing proc|
|00000230| 65 73 73 20 69 73 20 70 | 72 6f 62 61 62 6c 79 20 |ess is p|robably |
|00000240| 6e 6f 74 20 66 6f 6f 6c | 70 72 6f 6f 66 20 61 74 |not fool|proof at|
|00000250| 20 74 68 69 73 20 70 6f | 69 6e 74 2c 20 0a 73 6f | this po|int, .so|
|00000260| 20 79 6f 75 20 73 68 6f | 75 6c 64 20 66 69 72 73 | you sho|uld firs|
|00000270| 74 20 6c 6f 6f 6b 20 61 | 74 20 74 68 65 20 74 75 |t look a|t the tu|
|00000280| 74 6f 72 69 61 6c 0a 65 | 78 61 6d 70 6c 65 73 20 |torial.e|xamples |
|00000290| 74 6f 20 64 65 63 69 64 | 65 20 69 66 20 79 6f 75 |to decid|e if you|
|000002a0| 20 61 72 65 20 69 6e 74 | 65 72 65 73 74 65 64 20 | are int|erested |
|000002b0| 69 6e 20 74 68 65 73 65 | 20 65 78 74 65 6e 73 69 |in these| extensi|
|000002c0| 6f 6e 73 2e 0a 49 74 20 | 69 73 20 65 78 70 65 63 |ons..It |is expec|
|000002d0| 74 65 64 20 74 68 61 74 | 20 74 68 65 20 69 6e 73 |ted that| the ins|
|000002e0| 74 72 75 63 74 69 6f 6e | 73 20 6d 61 79 20 62 65 |truction|s may be|
|000002f0| 20 75 6e 63 6c 65 61 72 | 20 69 6e 20 70 6c 61 63 | unclear| in plac|
|00000300| 65 73 2e 20 20 0a 50 6c | 65 61 73 65 20 73 65 6e |es. .Pl|ease sen|
|00000310| 64 20 6d 61 69 6c 20 74 | 6f 20 7a 69 6c 6c 61 40 |d mail t|o zilla@|
|00000320| 63 63 72 6c 2e 6e 6a 2e | 6e 65 63 2e 63 6f 6d 20 |ccrl.nj.|nec.com |
|00000330| 69 66 20 79 6f 75 20 68 | 61 76 65 20 70 72 6f 62 |if you h|ave prob|
|00000340| 6c 65 6d 73 3b 0a 49 20 | 6d 61 79 20 62 65 20 72 |lems;.I |may be r|
|00000350| 65 61 63 68 61 62 6c 65 | 20 62 79 20 70 68 6f 6e |eachable| by phon|
|00000360| 65 20 61 74 20 36 30 39 | 20 39 35 31 20 32 34 36 |e at 609| 951 246|
|00000370| 34 20 6f 72 20 36 30 39 | 20 39 35 31 20 32 34 34 |4 or 609| 951 244|
|00000380| 31 20 0a 69 66 20 74 68 | 65 72 65 20 69 73 20 6e |1 .if th|ere is n|
|00000390| 6f 20 72 65 73 70 6f 6e | 73 65 20 66 72 6f 6d 20 |o respon|se from |
|000003a0| 74 68 65 20 65 2d 6d 61 | 69 6c 20 61 64 64 72 65 |the e-ma|il addre|
|000003b0| 73 73 2e 0a 0a 57 61 72 | 6e 69 6e 67 3a 20 74 68 |ss...War|ning: th|
|000003c0| 65 20 66 6f 6c 6c 6f 77 | 69 6e 67 20 66 69 6c 65 |e follow|ing file|
|000003d0| 73 20 66 72 6f 6d 20 74 | 68 65 20 73 74 61 6e 64 |s from t|he stand|
|000003e0| 61 72 64 20 45 6c 6b 20 | 64 69 73 74 72 69 62 75 |ard Elk |distribu|
|000003f0| 74 69 6f 6e 0a 61 72 65 | 20 77 72 69 74 74 65 6e |tion.are| written|
|00000400| 20 6f 76 65 72 20 64 75 | 72 69 6e 67 20 74 68 65 | over du|ring the|
|00000410| 20 69 6e 73 74 61 6c 6c | 61 74 69 6f 6e 20 6f 66 | install|ation of|
|00000420| 20 74 68 65 73 65 20 65 | 78 74 65 6e 73 69 6f 6e | these e|xtension|
|00000430| 73 3a 0a 49 6e 20 73 72 | 63 2f 2c 20 6c 6f 61 64 |s:.In sr|c/, load|
|00000440| 2e 63 2c 20 6d 61 69 6e | 2e 63 2c 20 6d 61 74 68 |.c, main|.c, math|
|00000450| 2e 63 2c 20 70 72 6f 63 | 2e 63 2c 20 73 74 61 62 |.c, proc|.c, stab|
|00000460| 2e 63 2c 20 74 79 70 65 | 2e 63 2c 20 6f 62 6a 65 |.c, type|.c, obje|
|00000470| 63 74 2e 68 2e 0a 49 6e | 20 73 63 6d 2f 2c 20 74 |ct.h..In| scm/, t|
|00000480| 6f 70 6c 65 76 65 6c 2e | 0a 0a 54 68 65 20 62 75 |oplevel.|..The bu|
|00000490| 69 6c 64 20 66 69 6c 65 | 73 20 66 6f 72 20 74 68 |ild file|s for th|
|000004a0| 65 20 65 78 74 65 6e 73 | 69 6f 6e 73 20 61 73 73 |e extens|ions ass|
|000004b0| 75 6d 65 20 74 68 61 74 | 20 74 68 65 20 65 78 74 |ume that| the ext|
|000004c0| 65 6e 73 69 6f 6e 73 0a | 61 72 65 20 6c 6f 63 61 |ensions.|are loca|
|000004d0| 74 65 64 20 69 6e 20 63 | 6f 6e 74 72 69 62 2f 7a |ted in c|ontrib/z|
|000004e0| 65 6c 6b 20 72 65 6c 61 | 74 69 76 65 20 74 6f 20 |elk rela|tive to |
|000004f0| 74 68 65 20 74 6f 70 20 | 6c 65 76 65 6c 20 65 6c |the top |level el|
|00000500| 6b 20 73 6f 75 72 63 65 | 0a 64 69 72 65 63 74 6f |k source|.directo|
|00000510| 72 79 2e 20 20 0a 0a 5c | 73 75 62 73 65 63 74 69 |ry. ..\|subsecti|
|00000520| 6f 6e 2a 7b 42 75 69 6c | 64 20 45 6c 6b 20 57 69 |on*{Buil|d Elk Wi|
|00000530| 74 68 6f 75 74 20 45 78 | 74 65 6e 73 69 6f 6e 73 |thout Ex|tensions|
|00000540| 7d 0a 50 6c 65 61 73 65 | 20 62 75 69 6c 64 20 74 |}.Please| build t|
|00000550| 68 65 20 75 6e 6d 6f 64 | 69 66 69 65 64 20 45 6c |he unmod|ified El|
|00000560| 6b 20 66 69 72 73 74 2c | 20 0a 69 6e 20 6f 72 64 |k first,| .in ord|
|00000570| 65 72 20 74 6f 20 68 65 | 6c 70 20 69 73 6f 6c 61 |er to he|lp isola|
|00000580| 74 65 20 61 6e 79 20 70 | 72 6f 62 6c 65 6d 73 20 |te any p|roblems |
|00000590| 77 68 69 63 68 20 61 72 | 65 20 63 61 75 73 65 64 |which ar|e caused|
|000005a0| 20 62 79 20 74 68 65 20 | 65 78 74 65 6e 73 69 6f | by the |extensio|
|000005b0| 6e 73 2e 0a 0a 5c 73 75 | 62 73 65 63 74 69 6f 6e |ns...\su|bsection|
|000005c0| 2a 7b 42 75 69 6c 64 20 | 74 68 65 20 45 78 74 65 |*{Build |the Exte|
|000005d0| 6e 73 69 6f 6e 73 7d 0a | 0a 49 6e 20 74 68 65 20 |nsions}.|.In the |
|000005e0| 72 65 6d 61 69 6e 69 6e | 67 20 69 6e 73 74 72 75 |remainin|g instru|
|000005f0| 63 74 69 6f 6e 73 20 54 | 4f 50 20 72 65 66 65 72 |ctions T|OP refer|
|00000600| 73 20 74 6f 20 74 68 65 | 20 74 6f 70 20 6c 65 76 |s to the| top lev|
|00000610| 65 6c 20 65 6c 6b 20 73 | 6f 75 72 63 65 20 64 69 |el elk s|ource di|
|00000620| 72 65 63 74 6f 72 79 0a | 61 6e 64 20 5a 45 4c 4b |rectory.|and ZELK|
|00000630| 20 72 65 66 65 72 73 20 | 74 6f 20 74 68 65 20 64 | refers |to the d|
|00000640| 69 72 65 63 74 6f 72 79 | 20 54 4f 50 2f 63 6f 6e |irectory| TOP/con|
|00000650| 74 72 69 62 2f 7a 65 6c | 6b 2e 0a 0a 54 68 65 20 |trib/zel|k...The |
|00000660| 65 78 74 65 6e 73 69 6f | 6e 73 20 77 69 6c 6c 20 |extensio|ns will |
|00000670| 62 65 20 6c 6f 63 61 74 | 65 64 20 69 6e 20 54 4f |be locat|ed in TO|
|00000680| 50 2f 63 6f 6e 74 72 69 | 62 2f 7a 65 6c 6b 2e 0a |P/contri|b/zelk..|
|00000690| 49 66 20 74 68 69 73 20 | 64 69 72 65 63 74 6f 72 |If this |director|
|000006a0| 79 20 64 6f 65 73 20 6e | 6f 74 20 61 6c 72 65 61 |y does n|ot alrea|
|000006b0| 64 79 20 65 78 69 73 74 | 2c 20 63 64 20 74 6f 20 |dy exist|, cd to |
|000006c0| 63 6f 6e 74 72 69 62 20 | 61 6e 64 20 75 6e 74 61 |contrib |and unta|
|000006d0| 72 20 7a 65 6c 6b 2e 74 | 61 72 2e 0a 0a 49 6e 20 |r zelk.t|ar...In |
|000006e0| 54 4f 50 2f 4d 61 6b 65 | 66 69 6c 65 2c 20 61 64 |TOP/Make|file, ad|
|000006f0| 64 20 63 6f 6e 74 72 69 | 62 2f 7a 65 6c 6b 20 61 |d contri|b/zelk a|
|00000700| 73 20 74 68 65 20 73 65 | 63 6f 6e 64 20 74 61 72 |s the se|cond tar|
|00000710| 67 65 74 20 28 61 66 74 | 65 72 20 69 6e 63 6c 75 |get (aft|er inclu|
|00000720| 64 65 29 2c 0a 61 6e 64 | 20 6d 6f 76 65 20 74 68 |de),.and| move th|
|00000730| 65 20 74 61 72 67 65 74 | 20 6c 69 62 2f 6d 69 73 |e target| lib/mis|
|00000740| 63 20 62 65 66 6f 72 65 | 20 74 68 65 20 74 61 72 |c before| the tar|
|00000750| 67 65 74 20 73 72 63 3a | 0a 5c 62 65 67 69 6e 7b |get src:|.\begin{|
|00000760| 76 65 72 62 61 74 69 6d | 7d 0a 53 55 42 44 49 52 |verbatim|}.SUBDIR|
|00000770| 53 3d 69 6e 63 6c 75 64 | 65 5c 20 0a 20 20 20 20 |S=includ|e\ . |
|00000780| 63 6f 6e 74 72 69 62 2f | 7a 65 6c 6b 5c 0a 20 20 |contrib/|zelk\. |
|00000790| 20 20 20 20 20 20 73 63 | 72 69 70 74 73 5c 0a 20 | sc|ripts\. |
|000007a0| 20 20 20 6c 69 62 2f 6d | 69 73 63 5c 0a 20 20 20 | lib/m|isc\. |
|000007b0| 20 20 20 20 20 73 72 63 | 5c 0a 20 20 20 20 20 20 | src|\. |
|000007c0| 20 20 73 63 6d 5c 0a 20 | 20 20 20 20 20 20 20 6c | scm\. | l|
|000007d0| 69 62 2f 75 74 69 6c 5c | 20 0a 20 20 20 20 20 20 |ib/util\| . |
|000007e0| 20 20 2e 2e 2e 2e 0a 5c | 65 6e 64 7b 76 65 72 62 | .....\|end{verb|
|000007f0| 61 74 69 6d 7d 0a 0a 43 | 6f 70 79 20 6f 72 20 6d |atim}..C|opy or m|
|00000800| 6f 76 65 20 74 68 65 20 | 73 79 73 74 65 6d 20 63 |ove the |system c|
|00000810| 6f 6e 66 69 67 75 72 61 | 74 69 6f 6e 20 66 69 6c |onfigura|tion fil|
|00000820| 65 73 20 69 6e 20 5a 45 | 4c 4b 2f 63 6f 6e 66 69 |es in ZE|LK/confi|
|00000830| 67 2f 20 74 6f 20 54 4f | 50 2f 63 6f 6e 66 69 67 |g/ to TO|P/config|
|00000840| 2e 0a 0a 49 6e 20 54 4f | 50 2f 63 6f 6e 66 69 67 |...In TO|P/config|
|00000850| 2c 20 6c 69 6e 6b 20 6f | 6e 65 20 6f 66 20 74 68 |, link o|ne of th|
|00000860| 65 20 58 58 2d 7a 65 6c | 6b 20 66 69 6c 65 73 20 |e XX-zel|k files |
|00000870| 74 6f 20 73 79 73 74 65 | 6d 2c 20 66 6f 72 20 65 |to syste|m, for e|
|00000880| 78 61 6d 70 6c 65 2c 0a | 5c 62 65 67 69 6e 7b 76 |xample,.|\begin{v|
|00000890| 65 72 62 61 74 69 6d 7d | 0a 20 20 20 20 6c 6e 20 |erbatim}|. ln |
|000008a0| 2d 73 20 73 75 6e 34 2d | 73 75 6e 6f 73 34 2e 31 |-s sun4-|sunos4.1|
|000008b0| 2d 63 63 2d 7a 65 6c 6b | 20 73 79 73 74 65 6d 0a |-cc-zelk| system.|
|000008c0| 5c 65 6e 64 7b 76 65 72 | 62 61 74 69 6d 7d 0a 41 |\end{ver|batim}.A|
|000008d0| 73 20 6f 66 20 4e 6f 76 | 65 6d 62 65 72 20 39 32 |s of Nov|ember 92|
|000008e0| 20 74 68 65 73 65 20 65 | 78 74 65 6e 73 69 6f 6e | these e|xtension|
|000008f0| 73 20 63 61 6e 20 62 65 | 20 63 6f 6d 70 69 6c 65 |s can be| compile|
|00000900| 64 20 6f 6e 20 53 55 4e | 2f 73 70 61 72 63 0a 6d |d on SUN|/sparc.m|
|00000910| 61 63 68 69 6e 65 73 20 | 75 73 69 6e 67 20 63 63 |achines |using cc|
|00000920| 2c 20 61 6e 64 20 6f 6e | 20 53 47 49 2f 49 72 69 |, and on| SGI/Iri|
|00000930| 78 34 20 6d 61 63 68 69 | 6e 65 73 20 61 6c 73 6f |x4 machi|nes also|
|00000940| 20 75 73 69 6e 67 20 63 | 63 2e 0a 4f 6e 20 74 68 | using c|c..On th|
|00000950| 65 20 53 75 6e 2c 20 74 | 68 65 20 63 6f 75 70 6c |e Sun, t|he coupl|
|00000960| 65 20 6f 66 20 61 73 6d | 28 29 20 73 74 61 74 65 |e of asm|() state|
|00000970| 6d 65 6e 74 73 20 77 68 | 69 63 68 20 69 6d 70 6c |ments wh|ich impl|
|00000980| 65 6d 65 6e 74 20 74 68 | 65 20 66 6f 72 65 69 67 |ement th|e foreig|
|00000990| 6e 20 0a 66 75 6e 63 74 | 69 6f 6e 20 69 6e 74 65 |n .funct|ion inte|
|000009a0| 72 66 61 63 65 20 28 66 | 6f 72 66 75 6e 63 2e 63 |rface (f|orfunc.c|
|000009b0| 29 20 64 6f 20 6e 6f 74 | 20 63 6f 6d 70 69 6c 65 |) do not| compile|
|000009c0| 20 63 6f 72 72 65 63 74 | 6c 79 20 77 69 74 68 20 | correct|ly with |
|000009d0| 67 63 63 2e 0a 54 68 65 | 20 76 65 63 74 6f 72 20 |gcc..The| vector |
|000009e0| 65 78 74 65 6e 73 69 6f | 6e 73 20 28 66 76 65 63 |extensio|ns (fvec|
|000009f0| 74 6f 72 2e 63 29 20 72 | 65 71 75 69 72 65 20 61 |tor.c) r|equire a|
|00000a00| 6e 20 41 4e 53 49 20 43 | 20 63 6f 6d 70 69 6c 65 |n ANSI C| compile|
|00000a10| 72 2c 20 0a 68 6f 77 65 | 76 65 72 2c 20 61 6e 64 |r, .howe|ver, and|
|00000a20| 20 73 6f 20 6d 75 73 74 | 20 65 69 74 68 65 72 20 | so must| either |
|00000a30| 62 65 20 6c 65 66 74 20 | 6f 75 74 20 6f 72 20 62 |be left |out or b|
|00000a40| 65 20 63 6f 6d 70 69 6c | 65 64 20 77 69 74 68 20 |e compil|ed with |
|00000a50| 67 63 63 2e 0a 54 68 69 | 73 20 63 68 6f 69 63 65 |gcc..Thi|s choice|
|00000a60| 20 69 73 20 73 65 6c 65 | 63 74 65 64 20 61 73 20 | is sele|cted as |
|00000a70| 69 6e 64 69 63 61 74 65 | 64 20 62 65 6c 6f 77 2e |indicate|d below.|
|00000a80| 20 0a 0a 43 75 73 74 6f | 6d 69 7a 65 20 74 68 69 | ..Custo|mize thi|
|00000a90| 73 20 73 79 73 74 65 6d | 20 66 69 6c 65 20 69 6e |s system| file in|
|00000aa0| 20 74 68 65 20 73 61 6d | 65 20 77 61 79 20 61 73 | the sam|e way as|
|00000ab0| 20 77 69 74 68 20 74 68 | 65 20 6e 6f 72 6d 61 6c | with th|e normal|
|00000ac0| 20 65 6c 6b 20 69 6e 73 | 74 61 6c 6c 61 74 69 6f | elk ins|tallatio|
|00000ad0| 6e 2e 0a 54 68 65 6e 20 | 65 64 69 74 20 74 68 65 |n..Then |edit the|
|00000ae0| 20 65 6e 64 20 6f 66 20 | 74 68 65 20 66 69 6c 65 | end of |the file|
|00000af0| 2c 20 66 6f 6c 6c 6f 77 | 69 6e 67 20 74 68 65 20 |, follow|ing the |
|00000b00| 6c 69 6e 65 0a 5c 62 65 | 67 69 6e 7b 76 65 72 62 |line.\be|gin{verb|
|00000b10| 61 74 69 6d 7d 0a 20 20 | 20 20 23 23 23 23 23 23 |atim}. | ######|
|00000b20| 23 23 23 23 23 23 23 23 | 23 23 20 7a 65 6c 6b 20 |########|## zelk |
|00000b30| 65 78 74 65 6e 73 69 6f | 6e 73 20 73 74 75 66 66 |extensio|ns stuff|
|00000b40| 20 23 23 23 23 23 23 23 | 23 23 23 23 23 23 23 23 | #######|########|
|00000b50| 23 0a 20 20 20 20 23 20 | 73 65 74 20 74 68 69 73 |#. # |set this|
|00000b60| 20 74 6f 20 74 68 65 20 | 65 6c 6b 20 73 6f 75 72 | to the |elk sour|
|00000b70| 63 65 20 64 69 72 65 63 | 74 6f 72 79 0a 20 20 20 |ce direc|tory. |
|00000b80| 20 65 6c 6b 74 6f 70 3d | 2f 75 73 72 2f 6c 6f 63 | elktop=|/usr/loc|
|00000b90| 61 6c 2f 70 75 62 2f 73 | 72 63 2f 65 6c 6b 32 0a |al/pub/s|rc/elk2.|
|00000ba0| 0a 20 20 20 20 23 20 69 | 6e 63 6c 75 64 65 20 76 |. # i|nclude v|
|00000bb0| 65 63 74 6f 72 20 65 78 | 74 65 6e 73 69 6f 6e 73 |ector ex|tensions|
|00000bc0| 3f 20 54 68 65 79 20 72 | 65 71 75 69 72 65 20 61 |? They r|equire a|
|00000bd0| 6e 20 61 6e 73 69 20 63 | 6f 6d 70 69 6c 65 72 3b |n ansi c|ompiler;|
|00000be0| 20 0a 20 20 20 20 23 20 | 73 65 6c 65 63 74 20 6f | . # |select o|
|00000bf0| 6e 65 20 6f 66 20 27 66 | 76 65 63 74 6f 72 67 63 |ne of 'f|vectorgc|
|00000c00| 63 2e 6f 27 2c 20 27 66 | 76 65 63 74 6f 72 73 67 |c.o', 'f|vectorsg|
|00000c10| 69 2e 6f 27 2c 20 6f 72 | 20 27 66 76 65 63 74 6f |i.o', or| 'fvecto|
|00000c20| 72 6e 6f 6e 65 2e 6f 27 | 20 20 0a 20 20 20 20 66 |rnone.o'| . f|
|00000c30| 76 65 63 74 6f 72 3d 66 | 76 65 63 74 6f 72 67 63 |vector=f|vectorgc|
|00000c40| 63 2e 6f 0a 5c 65 6e 64 | 7b 76 65 72 62 61 74 69 |c.o.\end|{verbati|
|00000c50| 6d 7d 0a 48 65 72 65 2c | 20 69 6e 64 69 63 61 74 |m}.Here,| indicat|
|00000c60| 65 20 74 68 65 20 70 61 | 74 68 20 6f 66 20 74 68 |e the pa|th of th|
|00000c70| 65 20 74 6f 70 20 6c 65 | 76 65 6c 20 65 6c 6b 20 |e top le|vel elk |
|00000c80| 73 6f 75 72 63 65 20 64 | 69 72 65 63 74 6f 72 79 |source d|irectory|
|00000c90| 2c 0a 61 6e 64 20 77 68 | 65 74 68 65 72 20 79 6f |,.and wh|ether yo|
|00000ca0| 75 20 77 61 6e 74 20 74 | 6f 20 69 6e 63 6c 75 64 |u want t|o includ|
|00000cb0| 65 20 74 68 65 20 65 6c | 6b 20 76 65 63 74 6f 72 |e the el|k vector|
|00000cc0| 20 65 78 74 65 6e 73 69 | 6f 6e 73 2e 0a 54 68 65 | extensi|ons..The|
|00000cd0| 20 76 65 63 74 6f 72 20 | 65 78 74 65 6e 73 69 6f | vector |extensio|
|00000ce0| 6e 73 20 72 65 71 75 69 | 72 65 20 61 6e 20 41 4e |ns requi|re an AN|
|00000cf0| 53 49 20 63 6f 6d 70 69 | 6c 65 72 3b 20 0a 6f 6e |SI compi|ler; .on|
|00000d00| 20 74 68 65 20 53 75 6e | 20 74 68 65 20 61 76 61 | the Sun| the ava|
|00000d10| 69 6c 61 62 69 6c 69 74 | 79 20 6f 66 20 67 63 63 |ilabilit|y of gcc|
|00000d20| 20 69 73 20 61 73 73 75 | 6d 65 64 2e 0a 0a 43 6f | is assu|med...Co|
|00000d30| 70 79 20 5a 45 4c 4b 2f | 73 63 6d 2f 2e 65 6c 6b |py ZELK/|scm/.elk|
|00000d40| 72 63 20 74 6f 20 79 6f | 75 72 20 68 6f 6d 65 20 |rc to yo|ur home |
|00000d50| 64 69 72 65 63 74 6f 72 | 79 2e 20 43 75 73 74 6f |director|y. Custo|
|00000d60| 6d 69 7a 65 20 74 68 69 | 73 20 66 69 6c 65 20 6c |mize thi|s file l|
|00000d70| 61 74 65 72 2e 0a 0a 4e | 6f 77 20 60 6d 61 6b 65 |ater...N|ow `make|
|00000d80| 27 2c 20 61 6e 64 20 74 | 68 65 6e 20 60 6d 61 6b |', and t|hen `mak|
|00000d90| 65 20 69 6e 73 74 61 6c | 6c 27 2e 0a 0a 5c 73 75 |e instal|l'...\su|
|00000da0| 62 73 65 63 74 69 6f 6e | 2a 7b 54 65 73 74 20 74 |bsection|*{Test t|
|00000db0| 68 65 20 45 78 74 65 6e | 73 69 6f 6e 73 7d 0a 53 |he Exten|sions}.S|
|00000dc0| 6f 6d 65 20 73 69 6d 70 | 6c 65 20 74 65 73 74 73 |ome simp|le tests|
|00000dd0| 20 77 68 69 63 68 20 77 | 69 6c 6c 20 69 6e 64 69 | which w|ill indi|
|00000de0| 63 61 74 65 20 69 66 20 | 74 68 65 20 65 78 74 65 |cate if |the exte|
|00000df0| 6e 73 69 6f 6e 73 20 61 | 72 65 20 77 6f 72 6b 69 |nsions a|re worki|
|00000e00| 6e 67 3a 0a 0a 5c 62 65 | 67 69 6e 7b 76 65 72 62 |ng:..\be|gin{verb|
|00000e10| 61 74 69 6d 7d 0a 20 20 | 28 61 70 72 6f 70 6f 73 |atim}. |(apropos|
|00000e20| 20 22 6f 73 2d 22 29 0a | 5c 65 6e 64 7b 76 65 72 | "os-").|\end{ver|
|00000e30| 62 61 74 69 6d 7d 0a 54 | 68 69 73 20 73 68 6f 75 |batim}.T|his shou|
|00000e40| 6c 64 20 6c 69 73 74 20 | 73 68 65 6c 6c 20 6f 72 |ld list |shell or|
|00000e50| 20 6f 70 65 72 61 74 69 | 6e 67 20 73 79 73 74 65 | operati|ng syste|
|00000e60| 6d 2d 72 65 6c 61 74 65 | 64 20 66 75 6e 63 74 69 |m-relate|d functi|
|00000e70| 6f 6e 73 20 6c 69 6e 6b | 65 64 0a 74 68 72 6f 75 |ons link|ed.throu|
|00000e80| 67 68 20 74 68 65 20 66 | 6f 72 65 69 67 6e 20 66 |gh the f|oreign f|
|00000e90| 75 6e 63 74 69 6f 6e 20 | 69 6e 74 65 72 66 61 63 |unction |interfac|
|00000ea0| 65 2e 0a 0a 5c 62 65 67 | 69 6e 7b 76 65 72 62 61 |e...\beg|in{verba|
|00000eb0| 74 69 6d 7d 0a 20 20 28 | 6f 73 2d 74 69 6d 65 73 |tim}. (|os-times|
|00000ec0| 74 72 69 6e 67 20 28 6f | 73 2d 66 69 6c 65 6d 6f |tring (o|s-filemo|
|00000ed0| 64 74 69 6d 65 20 22 2f | 65 74 63 2f 70 61 73 73 |dtime "/|etc/pass|
|00000ee0| 77 64 22 29 29 0a 5c 65 | 6e 64 7b 76 65 72 62 61 |wd")).\e|nd{verba|
|00000ef0| 74 69 6d 7d 0a 54 68 69 | 73 20 73 68 6f 75 6c 64 |tim}.Thi|s should|
|00000f00| 20 72 65 74 75 72 6e 20 | 74 68 65 20 6c 61 73 74 | return |the last|
|00000f10| 2d 6d 6f 64 69 66 69 65 | 64 20 64 61 74 65 20 6f |-modifie|d date o|
|00000f20| 66 20 74 68 65 20 69 6e | 64 69 63 61 74 65 64 20 |f the in|dicated |
|00000f30| 66 69 6c 65 2e 0a 49 74 | 20 69 6e 64 69 63 61 74 |file..It| indicat|
|00000f40| 65 73 20 74 68 61 74 20 | 74 68 65 20 66 6f 72 65 |es that |the fore|
|00000f50| 69 67 6e 20 66 75 6e 63 | 74 69 6f 6e 20 69 6e 74 |ign func|tion int|
|00000f60| 65 72 66 61 63 65 20 69 | 73 20 77 6f 72 6b 69 6e |erface i|s workin|
|00000f70| 67 2e 0a 0a 5c 62 65 67 | 69 6e 7b 76 65 72 62 61 |g...\beg|in{verba|
|00000f80| 74 69 6d 7d 0a 20 20 28 | 61 70 72 6f 70 6f 73 20 |tim}. (|apropos |
|00000f90| 22 76 2d 22 29 0a 5c 65 | 6e 64 7b 76 65 72 62 61 |"v-").\e|nd{verba|
|00000fa0| 74 69 6d 7d 0a 54 68 69 | 73 20 73 68 6f 75 6c 64 |tim}.Thi|s should|
|00000fb0| 20 6c 69 73 74 20 74 68 | 65 20 76 65 63 74 6f 72 | list th|e vector|
|00000fc0| 20 65 78 74 65 6e 73 69 | 6f 6e 20 72 6f 75 74 69 | extensi|on routi|
|00000fd0| 6e 65 73 2c 20 69 66 20 | 74 68 65 79 20 77 65 72 |nes, if |they wer|
|00000fe0| 65 20 73 65 6c 65 63 74 | 65 64 2e 0a 0a 5c 62 65 |e select|ed...\be|
|00000ff0| 67 69 6e 7b 76 65 72 62 | 61 74 69 6d 7d 0a 20 20 |gin{verb|atim}. |
|00001000| 28 76 2d 2b 20 31 30 2e | 20 28 76 2d 69 6e 64 65 |(v-+ 10.| (v-inde|
|00001010| 78 20 35 29 29 20 20 3d | 3e 20 28 25 20 31 30 2e |x 5)) =|> (% 10.|
|00001020| 30 20 31 31 2e 30 20 31 | 32 2e 30 20 31 33 2e 30 |0 11.0 1|2.0 13.0|
|00001030| 20 31 34 2e 30 29 0a 5c | 65 6e 64 7b 76 65 72 62 | 14.0).\|end{verb|
|00001040| 61 74 69 6d 7d 0a 49 6e | 64 69 63 61 74 65 73 20 |atim}.In|dicates |
|00001050| 74 68 65 20 76 65 63 74 | 6f 72 20 65 78 74 65 6e |the vect|or exten|
|00001060| 73 69 6f 6e 73 20 61 72 | 65 20 77 6f 72 6b 69 6e |sions ar|e workin|
|00001070| 67 2e 0a 0a 5c 62 65 67 | 69 6e 7b 76 65 72 62 61 |g...\beg|in{verba|
|00001080| 74 69 6d 7d 0a 20 20 28 | 6c 6f 61 64 20 22 73 68 |tim}. (|load "sh|
|00001090| 65 6c 6c 2e 65 22 29 0a | 5c 65 6e 64 7b 76 65 72 |ell.e").|\end{ver|
|000010a0| 62 61 74 69 6d 7d 0a 54 | 65 73 74 20 74 68 61 74 |batim}.T|est that|
|000010b0| 20 74 68 65 20 73 63 68 | 65 6d 65 20 6c 69 62 72 | the sch|eme libr|
|000010c0| 61 72 79 20 66 69 6c 65 | 73 20 69 6e 63 6c 75 64 |ary file|s includ|
|000010d0| 65 64 20 74 68 65 20 65 | 78 74 65 6e 73 69 6f 6e |ed the e|xtension|
|000010e0| 20 0a 61 72 65 20 66 6f | 75 6e 64 20 6f 6e 20 74 | .are fo|und on t|
|000010f0| 68 65 20 6c 6f 61 64 20 | 70 61 74 68 2e 0a 0a 5c |he load |path...\|
|00001100| 62 65 67 69 6e 7b 76 65 | 72 62 61 74 69 6d 7d 0a |begin{ve|rbatim}.|
|00001110| 20 20 28 64 65 63 6c 61 | 72 65 2d 73 68 65 6c 6c | (decla|re-shell|
|00001120| 20 6c 73 20 72 77 68 6f | 20 63 61 74 29 0a 20 20 | ls rwho| cat). |
|00001130| 28 6c 73 29 0a 20 20 28 | 6c 73 20 22 2f 74 6d 70 |(ls). (|ls "/tmp|
|00001140| 22 29 0a 5c 65 6e 64 7b | 76 65 72 62 61 74 69 6d |").\end{|verbatim|
|00001150| 7d 0a 54 65 73 74 20 74 | 68 65 20 64 65 63 6c 61 |}.Test t|he decla|
|00001160| 72 65 2d 73 68 65 6c 6c | 20 63 6f 6e 73 74 72 75 |re-shell| constru|
|00001170| 63 74 20 66 72 6f 6d 20 | 73 68 65 6c 6c 2e 65 2e |ct from |shell.e.|
|00001180| 0a 0a 5c 73 75 62 73 65 | 63 74 69 6f 6e 2a 7b 47 |..\subse|ction*{G|
|00001190| 75 69 64 65 20 74 6f 20 | 74 68 65 20 46 69 6c 65 |uide to |the File|
|000011a0| 73 7d 0a 5c 62 65 67 69 | 6e 7b 76 65 72 62 61 74 |s}.\begi|n{verbat|
|000011b0| 69 6d 7d 0a 0a 49 6e 20 | 63 6f 6e 74 72 69 62 2f |im}..In |contrib/|
|000011c0| 7a 65 6c 6b 2f 0a 63 6f | 6e 66 69 67 20 20 20 20 |zelk/.co|nfig |
|000011d0| 20 20 20 20 20 20 63 6f | 6e 74 61 69 6e 73 20 73 | co|ntains s|
|000011e0| 79 73 74 65 6d 20 63 6f | 6e 66 69 67 75 72 61 74 |ystem co|nfigurat|
|000011f0| 69 6f 6e 20 66 69 6c 65 | 73 20 77 68 69 63 68 20 |ion file|s which |
|00001200| 73 68 6f 75 6c 64 20 62 | 65 20 63 6f 70 69 65 64 |should b|e copied|
|00001210| 20 0a 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | . | |
|00001220| 20 20 69 6e 74 6f 20 54 | 4f 50 2f 63 6f 6e 66 69 | into T|OP/confi|
|00001230| 67 2e 0a 0a 73 63 6d 20 | 20 20 20 20 20 20 20 20 |g...scm | |
|00001240| 20 20 20 20 63 6f 6e 74 | 61 69 6e 73 20 73 61 6d | cont|ains sam|
|00001250| 70 6c 65 20 73 63 68 65 | 6d 65 20 66 69 6c 65 73 |ple sche|me files|
|00001260| 20 75 73 69 6e 67 20 74 | 68 65 20 65 6c 6b 20 65 | using t|he elk e|
|00001270| 78 74 65 6e 73 69 6f 6e | 73 0a 73 63 6d 2f 74 6f |xtension|s.scm/to|
|00001280| 70 6c 65 76 65 6c 2c 62 | 61 73 69 63 73 20 20 0a |plevel,b|asics .|
|00001290| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000012a0| 54 6f 70 6c 65 76 65 6c | 20 69 73 20 74 68 65 20 |Toplevel| is the |
|000012b0| 66 69 6c 65 20 77 68 69 | 63 68 20 45 6c 6b 20 6c |file whi|ch Elk l|
|000012c0| 6f 61 64 73 20 77 68 65 | 6e 20 69 74 20 72 75 6e |oads whe|n it run|
|000012d0| 73 3b 0a 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |s;. | |
|000012e0| 20 20 20 45 6c 6b 20 62 | 65 68 61 76 69 6f 72 20 | Elk b|ehavior |
|000012f0| 63 61 6e 20 62 65 20 63 | 75 73 74 6f 6d 69 7a 65 |can be c|ustomize|
|00001300| 64 20 62 79 20 63 68 61 | 6e 67 69 6e 67 20 74 68 |d by cha|nging th|
|00001310| 69 73 2e 0a 20 20 20 20 | 20 20 20 20 20 20 20 20 |is.. | |
|00001320| 20 20 20 20 54 6f 70 6c | 65 76 65 6c 20 68 61 73 | Topl|evel has|
|00001330| 20 62 65 65 6e 20 73 70 | 6c 69 74 20 69 6e 74 6f | been sp|lit into|
|00001340| 20 74 6f 70 6c 65 76 65 | 6c 20 61 6e 64 20 62 61 | topleve|l and ba|
|00001350| 73 69 63 73 20 66 6f 72 | 0a 20 20 20 20 20 20 20 |sics for|. |
|00001360| 20 20 20 20 20 20 20 20 | 20 72 65 61 73 6f 6e 73 | | reasons|
|00001370| 20 72 65 6c 61 74 69 6e | 67 20 74 6f 20 74 68 65 | relatin|g to the|
|00001380| 20 72 75 6e 6e 69 6e 67 | 20 6f 66 20 73 68 65 6c | running| of shel|
|00001390| 6c 20 66 69 6c 65 73 3b | 0a 20 20 20 20 20 20 20 |l files;|. |
|000013a0| 20 20 20 20 20 20 20 20 | 20 73 65 65 20 63 6f 6d | | see com|
|000013b0| 6d 65 6e 74 73 20 69 6e | 20 74 68 65 73 65 20 66 |ments in| these f|
|000013c0| 69 6c 65 73 2e 0a 20 20 | 20 20 20 20 20 20 20 20 |iles.. | |
|000013d0| 20 20 20 20 20 20 54 6f | 70 6c 65 76 65 6c 20 69 | To|plevel i|
|000013e0| 73 20 63 6f 70 69 65 64 | 20 69 6e 74 6f 20 45 6c |s copied| into El|
|000013f0| 6b 2f 73 63 6d 20 61 6e | 64 20 74 68 65 20 64 65 |k/scm an|d the de|
|00001400| 66 61 75 6c 74 20 74 6f | 70 6c 65 76 65 6c 0a 20 |fault to|plevel. |
|00001410| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 69 | | i|
|00001420| 73 20 72 65 6e 61 6d 65 | 64 20 74 6f 20 74 6f 70 |s rename|d to top|
|00001430| 6c 65 76 65 6c 2e 6f 6c | 64 2e 20 0a 73 63 6d 2f |level.ol|d. .scm/|
|00001440| 2e 65 6c 6b 72 63 20 20 | 20 20 20 20 54 68 65 20 |.elkrc | The |
|00001450| 6e 65 77 20 74 6f 70 6c | 65 76 65 6c 2f 62 61 73 |new topl|evel/bas|
|00001460| 69 63 73 20 73 74 61 72 | 74 75 70 20 61 6c 73 6f |ics star|tup also|
|00001470| 20 74 72 69 65 73 20 74 | 6f 20 6c 6f 61 64 20 61 | tries t|o load a|
|00001480| 20 66 69 6c 65 0a 20 20 | 20 20 20 20 20 20 20 20 | file. | |
|00001490| 20 20 20 20 20 20 6e 61 | 6d 65 64 20 2e 65 6c 6b | na|med .elk|
|000014a0| 72 63 20 66 72 6f 6d 20 | 79 6f 75 72 20 68 6f 6d |rc from |your hom|
|000014b0| 65 20 64 69 72 65 63 74 | 6f 72 79 20 28 24 48 4f |e direct|ory ($HO|
|000014c0| 4d 45 29 2e 20 20 54 68 | 69 73 0a 20 20 20 20 20 |ME). Th|is. |
|000014d0| 20 20 20 20 20 20 20 20 | 20 20 20 69 73 20 61 20 | | is a |
|000014e0| 73 61 6d 70 6c 65 20 6f | 66 20 73 75 63 68 20 61 |sample o|f such a|
|000014f0| 20 66 69 6c 65 3b 20 63 | 6f 70 79 20 69 74 20 74 | file; c|opy it t|
|00001500| 6f 20 79 6f 75 72 20 24 | 48 4f 4d 45 20 0a 20 20 |o your $|HOME . |
|00001510| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 61 6e | | an|
|00001520| 64 20 6d 6f 64 69 66 79 | 20 69 74 2e 0a 0a 73 72 |d modify| it...sr|
|00001530| 63 2d 7a 65 6c 6b 20 20 | 20 20 20 20 20 20 54 68 |c-zelk | Th|
|00001540| 65 20 73 6f 75 72 63 65 | 20 66 6f 72 20 74 68 65 |e source| for the|
|00001550| 20 65 78 74 65 6e 73 69 | 6f 6e 73 0a 20 20 20 20 | extensi|ons. |
|00001560| 20 20 20 20 66 6f 72 66 | 75 6e 63 2e 63 20 20 54 | forf|unc.c T|
|00001570| 68 65 20 66 6f 72 65 69 | 67 6e 20 66 75 6e 63 74 |he forei|gn funct|
|00001580| 69 6f 6e 20 69 6e 74 65 | 72 66 61 63 65 20 61 6e |ion inte|rface an|
|00001590| 64 20 53 70 61 72 63 20 | 63 6f 64 65 0a 20 20 20 |d Sparc |code. |
|000015a0| 20 20 20 20 20 46 4f 52 | 4d 49 50 53 2e 63 20 20 | FOR|MIPS.c |
|000015b0| 53 47 49 2f 4d 49 50 53 | 20 76 65 72 73 69 6f 6e |SGI/MIPS| version|
|000015c0| 20 6f 66 20 74 68 65 20 | 66 6f 72 65 69 67 6e 20 | of the |foreign |
|000015d0| 66 75 6e 63 74 69 6f 6e | 20 69 6e 74 65 72 66 61 |function| interfa|
|000015e0| 63 65 2e 0a 20 20 20 20 | 20 20 20 20 20 20 20 20 |ce.. | |
|000015f0| 20 20 20 20 20 20 20 54 | 68 69 73 20 66 69 6c 65 | T|his file|
|00001600| 20 69 73 20 2a 69 6e 63 | 6c 75 64 65 64 2a 20 69 | is *inc|luded* i|
|00001610| 6e 20 66 6f 72 66 75 6e | 63 2e 63 2e 0a 20 20 20 |n forfun|c.c.. |
|00001620| 20 20 20 20 20 4d 49 50 | 53 41 53 4d 2e 73 20 20 | MIP|SASM.s |
|00001630| 41 20 73 6d 61 6c 6c 20 | 61 73 73 65 6d 62 6c 65 |A small |assemble|
|00001640| 72 20 66 69 6c 65 20 66 | 6f 72 20 74 68 65 20 53 |r file f|or the S|
|00001650| 47 49 2f 4d 49 50 53 20 | 46 46 49 2e 0a 20 20 20 |GI/MIPS |FFI.. |
|00001660| 20 20 20 20 20 66 61 72 | 72 61 79 2e 63 20 20 20 | far|ray.c |
|00001670| 49 6d 70 6c 65 6d 65 6e | 74 73 20 22 66 6f 72 65 |Implemen|ts "fore|
|00001680| 69 67 6e 20 61 72 72 61 | 79 73 22 20 28 73 65 65 |ign arra|ys" (see|
|00001690| 20 74 75 74 6f 72 69 61 | 6c 29 2e 0a 20 20 20 20 | tutoria|l).. |
|000016a0| 20 20 20 20 66 6f 72 70 | 6b 67 2e 63 20 20 20 22 | forp|kg.c "|
|000016b0| 66 6f 72 65 69 67 6e 20 | 6c 69 62 72 61 72 69 65 |foreign |librarie|
|000016c0| 73 22 2e 20 20 0a 20 20 | 20 20 20 20 20 20 66 76 |s". . | fv|
|000016d0| 65 63 74 6f 72 2e 63 20 | 20 54 68 65 20 41 50 4c |ector.c | The APL|
|000016e0| 2d 6c 69 6b 65 20 76 65 | 63 74 6f 72 20 72 6f 75 |-like ve|ctor rou|
|000016f0| 74 69 6e 65 73 2e 0a 20 | 20 20 20 20 20 20 20 66 |tines.. | f|
|00001700| 6f 72 67 6c 2e 63 20 20 | 20 20 46 6f 72 65 69 67 |orgl.c | Foreig|
|00001710| 6e 20 66 75 6e 63 74 69 | 6f 6e 20 62 69 6e 64 69 |n functi|on bindi|
|00001720| 6e 67 73 20 74 6f 20 74 | 68 65 20 53 47 49 20 47 |ngs to t|he SGI G|
|00001730| 4c 20 67 72 61 70 68 69 | 63 73 20 6c 69 62 72 61 |L graphi|cs libra|
|00001740| 72 79 2e 0a 20 20 20 20 | 20 20 20 20 70 65 65 6b |ry.. | peek|
|00001750| 70 6f 6b 65 2e 63 20 4c | 6f 77 2d 6c 65 76 65 6c |poke.c L|ow-level|
|00001760| 20 70 65 65 6b 2f 70 6f | 6b 65 20 75 73 69 6e 67 | peek/po|ke using|
|00001770| 20 66 6f 72 65 69 67 6e | 20 61 72 72 61 79 73 2e | foreign| arrays.|
|00001780| 20 20 54 68 65 20 66 69 | 6c 65 0a 20 20 20 20 20 | The fi|le. |
|00001790| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 66 73 | | fs|
|000017a0| 74 72 75 63 74 2e 65 20 | 69 6d 70 6c 65 6d 65 6e |truct.e |implemen|
|000017b0| 74 73 20 43 20 73 74 72 | 75 63 74 75 72 65 73 20 |ts C str|uctures |
|000017c0| 69 6e 20 73 63 68 65 6d | 65 20 75 73 69 6e 67 20 |in schem|e using |
|000017d0| 74 68 69 73 2e 0a 20 20 | 20 20 20 20 20 20 7a 65 |this.. | ze|
|000017e0| 6c 6b 2e 63 20 20 20 20 | 20 52 6f 75 74 69 6e 65 |lk.c | Routine|
|000017f0| 73 20 61 6e 64 20 66 6f | 72 65 69 67 6e 20 66 75 |s and fo|reign fu|
|00001800| 6e 63 74 69 6f 6e 20 62 | 69 6e 64 69 6e 67 73 20 |nction b|indings |
|00001810| 66 6f 72 20 74 68 65 20 | 22 65 6c 6b 0a 20 20 20 |for the |"elk. |
|00001820| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001830| 73 68 65 6c 6c 22 2e 0a | 20 20 20 20 20 20 20 20 |shell"..| |
|00001840| 72 74 6c 74 65 73 74 2e | 63 20 20 41 20 73 61 6d |rtltest.|c A sam|
|00001850| 70 6c 65 20 66 6f 72 65 | 69 67 6e 20 6c 69 62 72 |ple fore|ign libr|
|00001860| 61 72 79 0a 20 20 20 20 | 20 20 20 20 20 20 20 20 |ary. | |
|00001870| 20 20 20 20 20 20 20 28 | 72 74 6c 20 69 73 20 6d | (|rtl is m|
|00001880| 6e 65 6d 6f 6e 69 63 20 | 66 6f 72 20 72 75 6e 2d |nemonic |for run-|
|00001890| 74 69 6d 65 2d 6c 6f 61 | 64 29 2e 0a 20 20 20 20 |time-loa|d).. |
|000018a0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 0a | | .|
|000018b0| 73 72 63 2d 65 6c 6b 20 | 20 20 20 20 20 20 20 20 |src-elk | |
|000018c0| 4d 6f 64 69 66 69 65 64 | 20 76 65 72 73 69 6f 6e |Modified| version|
|000018d0| 73 20 6f 66 20 61 20 66 | 65 77 20 66 69 6c 65 73 |s of a f|ew files|
|000018e0| 20 66 72 6f 6d 20 74 68 | 65 20 65 6c 6b 20 73 72 | from th|e elk sr|
|000018f0| 63 2f 20 64 69 72 65 63 | 74 6f 72 79 2e 0a 0a 73 |c/ direc|tory...s|
|00001900| 72 63 2d 7a 6c 69 62 20 | 20 20 20 20 20 20 20 53 |rc-zlib | S|
|00001910| 6f 75 72 63 65 20 66 6f | 72 20 6c 69 62 5a 2e 61 |ource fo|r libZ.a|
|00001920| 20 2d 20 73 6f 6d 65 20 | 6c 69 62 72 61 72 79 20 | - some |library |
|00001930| 72 6f 75 74 69 6e 65 73 | 20 0a 20 20 20 20 20 20 |routines| . |
|00001940| 20 20 20 20 20 20 20 20 | 20 20 28 6e 6f 74 20 73 | | (not s|
|00001950| 70 65 63 69 66 69 63 20 | 74 6f 20 73 63 68 65 6d |pecific |to schem|
|00001960| 65 29 20 74 68 61 74 20 | 61 72 65 20 75 73 65 64 |e) that |are used|
|00001970| 20 62 79 20 74 68 65 20 | 65 78 74 65 6e 73 69 6f | by the |extensio|
|00001980| 6e 73 2e 20 0a 20 20 20 | 20 20 20 20 20 20 20 20 |ns. . | |
|00001990| 20 20 20 20 20 0a 69 6e | 63 6c 75 64 65 20 20 20 | .in|clude |
|000019a0| 20 20 20 20 20 20 49 6e | 63 6c 75 64 65 20 66 69 | In|clude fi|
|000019b0| 6c 65 73 20 75 73 65 64 | 20 62 79 20 74 68 65 20 |les used| by the |
|000019c0| 65 78 74 65 6e 73 69 6f | 6e 73 20 61 6e 64 20 6c |extensio|ns and l|
|000019d0| 69 62 72 61 72 79 20 72 | 6f 75 74 69 6e 65 73 2e |ibrary r|outines.|
|000019e0| 0a 20 20 20 20 20 20 20 | 20 74 68 65 75 73 75 61 |. | theusua|
|000019f0| 6c 2e 68 20 54 68 69 73 | 20 66 69 6c 65 20 61 74 |l.h This| file at|
|00001a00| 74 65 6d 70 74 73 20 74 | 6f 20 69 73 6f 6c 61 74 |tempts t|o isolat|
|00001a10| 65 20 61 6c 6c 20 73 79 | 73 74 65 6d 20 64 65 70 |e all sy|stem dep|
|00001a20| 65 6e 64 65 6e 63 69 65 | 73 3b 0a 20 20 20 20 20 |endencie|s;. |
|00001a30| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 69 74 | | it|
|00001a40| 20 69 73 20 61 20 6d 65 | 73 73 20 63 6f 6e 73 65 | is a me|ss conse|
|00001a50| 71 75 65 6e 74 6c 79 2e | 0a 20 20 20 20 20 20 20 |quently.|. |
|00001a60| 20 7a 6c 69 62 2e 68 20 | 20 20 20 20 50 72 6f 74 | zlib.h | Prot|
|00001a70| 6f 74 79 70 65 73 20 66 | 6f 72 20 74 68 65 20 6c |otypes f|or the l|
|00001a80| 69 62 72 61 72 79 20 72 | 6f 75 74 69 6e 65 73 20 |ibrary r|outines |
|00001a90| 69 6e 20 73 72 63 2d 7a | 6c 69 62 2e 0a 5c 65 6e |in src-z|lib..\en|
|00001aa0| 64 7b 76 65 72 62 61 74 | 69 6d 7d 0a 0a 5c 73 75 |d{verbat|im}..\su|
|00001ab0| 62 73 65 63 74 69 6f 6e | 2a 7b 54 72 6f 75 62 6c |bsection|*{Troubl|
|00001ac0| 65 73 68 6f 6f 74 69 6e | 67 20 61 6e 64 20 44 65 |eshootin|g and De|
|00001ad0| 74 61 69 6c 73 7d 0a 0a | 53 69 6e 63 65 20 74 68 |tails}..|Since th|
|00001ae0| 65 20 6d 61 6b 65 20 6d | 61 79 20 6e 6f 74 20 77 |e make m|ay not w|
|00001af0| 6f 72 6b 2c 20 0a 61 20 | 67 75 69 64 65 20 74 6f |ork, .a |guide to|
|00001b00| 20 77 68 61 74 20 69 74 | 20 69 73 20 74 72 79 69 | what it| is tryi|
|00001b10| 6e 67 20 74 6f 20 64 6f | 20 77 69 6c 6c 20 62 65 |ng to do| will be|
|00001b20| 20 67 69 76 65 6e 3a 0a | 0a 54 68 65 20 73 65 63 | given:.|.The sec|
|00001b30| 6f 6e 64 20 74 61 72 67 | 65 74 20 69 6e 20 74 68 |ond targ|et in th|
|00001b40| 65 20 74 6f 70 20 6c 65 | 76 65 6c 20 6d 61 6b 65 |e top le|vel make|
|00001b50| 20 69 73 20 63 6f 6e 74 | 72 69 62 2f 7a 65 6c 6b | is cont|rib/zelk|
|00001b60| 2e 0a 54 68 65 20 6d 61 | 6b 65 20 63 64 27 73 20 |..The ma|ke cd's |
|00001b70| 74 6f 20 74 68 69 73 20 | 64 69 72 65 63 74 6f 72 |to this |director|
|00001b80| 79 20 61 6e 64 20 65 78 | 65 63 75 74 65 73 20 74 |y and ex|ecutes t|
|00001b90| 68 65 20 4d 61 6b 65 66 | 69 6c 65 20 74 68 65 72 |he Makef|ile ther|
|00001ba0| 65 2e 0a 0a 54 68 65 20 | 63 6f 6e 74 72 69 62 2f |e...The |contrib/|
|00001bb0| 7a 65 6c 6b 20 4d 61 6b | 65 66 69 6c 65 20 64 6f |zelk Mak|efile do|
|00001bc0| 65 73 20 74 68 65 73 65 | 20 74 68 69 6e 67 73 3a |es these| things:|
|00001bd0| 0a 5c 62 65 67 69 6e 7b | 69 74 65 6d 69 7a 65 7d |.\begin{|itemize}|
|00001be0| 0a 0a 5c 69 74 65 6d 0a | 72 75 6e 73 20 74 68 65 |..\item.|runs the|
|00001bf0| 20 73 68 65 6c 6c 20 66 | 69 6c 65 20 62 75 69 6c | shell f|ile buil|
|00001c00| 64 20 74 6f 20 6d 61 6b | 65 20 4d 61 6b 65 66 69 |d to mak|e Makefi|
|00001c10| 6c 65 2e 6c 6f 63 61 6c | 2c 20 0a 77 68 69 63 68 |le.local|, .which|
|00001c20| 20 74 68 65 6e 3a 0a 0a | 5c 69 74 65 6d 0a 43 6f | then:..|\item.Co|
|00001c30| 70 69 65 73 20 61 20 6d | 6f 64 69 66 69 65 64 20 |pies a m|odified |
|00001c40| 76 65 72 73 69 6f 6e 20 | 6f 66 20 74 68 65 20 73 |version |of the s|
|00001c50| 63 68 65 6d 65 20 74 6f | 70 6c 65 76 65 6c 20 66 |cheme to|plevel f|
|00001c60| 69 6c 65 20 74 6f 20 54 | 4f 50 2f 73 63 6d 2c 0a |ile to T|OP/scm,.|
|00001c70| 61 6e 64 20 63 6f 70 69 | 65 73 20 61 20 66 65 77 |and copi|es a few|
|00001c80| 20 6e 65 77 20 73 63 68 | 65 6d 65 20 73 6f 75 72 | new sch|eme sour|
|00001c90| 63 65 20 66 69 6c 65 73 | 20 74 6f 20 74 68 65 20 |ce files| to the |
|00001ca0| 73 63 68 65 6d 65 20 6c | 69 62 72 61 72 79 0a 64 |scheme l|ibrary.d|
|00001cb0| 69 72 65 63 74 6f 72 79 | 20 28 73 63 68 65 6d 65 |irectory| (scheme|
|00001cc0| 5c 5f 64 69 72 20 69 6e | 20 63 6f 6e 66 69 67 2f |\_dir in| config/|
|00001cd0| 73 69 74 65 29 2e 0a 0a | 5c 69 74 65 6d 0a 43 6f |site)...|\item.Co|
|00001ce0| 70 69 65 73 20 61 20 66 | 65 77 20 6d 6f 64 69 66 |pies a f|ew modif|
|00001cf0| 69 65 64 20 65 6c 6b 20 | 43 20 73 6f 75 72 63 65 |ied elk |C source|
|00001d00| 20 66 69 6c 65 73 20 69 | 6e 74 6f 20 54 4f 50 2f | files i|nto TOP/|
|00001d10| 73 72 63 3a 0a 6c 6f 61 | 64 2e 63 2c 6d 61 69 6e |src:.loa|d.c,main|
|00001d20| 2e 63 2c 20 6d 61 74 68 | 2e 63 2c 20 70 72 6f 63 |.c, math|.c, proc|
|00001d30| 2e 63 2c 20 74 79 70 65 | 2e 63 2c 20 6f 62 6a 65 |.c, type|.c, obje|
|00001d40| 63 74 2e 68 2e 0a 54 68 | 65 20 6d 6f 64 69 66 69 |ct.h..Th|e modifi|
|00001d50| 63 61 74 69 6f 6e 73 20 | 69 6e 63 6c 75 64 65 20 |cations |include |
|00001d60| 61 64 64 69 6e 67 20 68 | 6f 6f 6b 73 20 66 6f 72 |adding h|ooks for|
|00001d70| 20 74 68 65 20 66 6f 72 | 65 69 67 6e 20 66 75 6e | the for|eign fun|
|00001d80| 63 74 69 6f 6e 20 69 6e | 74 65 72 66 61 63 65 0a |ction in|terface.|
|00001d90| 28 70 72 6f 63 2e 63 2c | 20 6f 62 6a 65 63 74 2e |(proc.c,| object.|
|00001da0| 68 29 2c 0a 63 68 61 6e | 67 65 73 20 72 65 6c 61 |h),.chan|ges rela|
|00001db0| 74 65 64 20 74 6f 20 64 | 79 6e 61 6d 69 63 20 6c |ted to d|ynamic l|
|00001dc0| 6f 61 64 69 6e 67 20 61 | 6e 64 20 27 66 6f 72 65 |oading a|nd 'fore|
|00001dd0| 69 67 6e 20 6c 69 62 72 | 61 72 69 65 73 27 0a 28 |ign libr|aries'.(|
|00001de0| 73 74 61 62 2e 63 2c 20 | 6c 6f 61 64 2e 63 29 2c |stab.c, |load.c),|
|00001df0| 0a 63 68 61 6e 67 65 73 | 20 69 6e 20 74 68 65 20 |.changes| in the |
|00001e00| 62 65 68 61 76 69 6f 72 | 20 6f 66 20 6d 61 74 68 |behavior| of math|
|00001e10| 20 28 77 68 69 63 68 20 | 79 6f 75 20 6d 69 67 68 | (which |you migh|
|00001e20| 74 20 77 61 6e 74 20 74 | 6f 20 72 65 76 6f 6b 65 |t want t|o revoke|
|00001e30| 29 20 28 6d 61 74 68 2e | 63 29 2c 0a 61 6e 64 20 |) (math.|c),.and |
|00001e40| 69 6e 69 74 69 61 6c 69 | 7a 61 74 69 6f 6e 20 6f |initiali|zation o|
|00001e50| 66 20 74 68 65 20 65 78 | 74 65 6e 73 69 6f 6e 73 |f the ex|tensions|
|00001e60| 20 28 6d 61 69 6e 2e 63 | 29 2e 0a 0a 5c 69 74 65 | (main.c|)...\ite|
|00001e70| 6d 0a 43 6f 6d 70 69 6c | 65 73 20 74 68 65 20 65 |m.Compil|es the e|
|00001e80| 78 74 65 6e 73 69 6f 6e | 20 73 6f 75 72 63 65 73 |xtension| sources|
|00001e90| 20 69 6e 20 5a 45 4c 4b | 2f 73 72 63 2d 7a 65 6c | in ZELK|/src-zel|
|00001ea0| 6b 2e 0a 54 68 65 20 65 | 78 74 65 6e 73 69 6f 6e |k..The e|xtension|
|00001eb0| 73 20 61 72 65 20 6c 69 | 6e 6b 65 64 20 75 73 69 |s are li|nked usi|
|00001ec0| 6e 67 20 6c 64 20 2d 72 | 20 69 6e 74 6f 20 6f 6e |ng ld -r| into on|
|00001ed0| 65 20 6c 61 72 67 65 20 | 67 72 6f 75 70 65 64 20 |e large |grouped |
|00001ee0| 62 69 6e 61 72 79 20 66 | 69 6c 65 20 0a 5a 45 4c |binary f|ile .ZEL|
|00001ef0| 4b 2f 5a 65 6c 6b 2e 6f | 2c 20 77 68 69 63 68 20 |K/Zelk.o|, which |
|00001f00| 69 73 20 6c 61 74 65 72 | 20 6c 69 6e 6b 65 64 20 |is later| linked |
|00001f10| 77 69 74 68 20 45 6c 6b | 2e 20 20 0a 0a 5c 69 74 |with Elk|. ..\it|
|00001f20| 65 6d 0a 42 75 69 6c 64 | 73 20 6c 69 62 5a 2e 61 |em.Build|s libZ.a|
|00001f30| 2e 20 20 54 68 69 73 20 | 69 73 20 61 20 6c 69 62 |. This |is a lib|
|00001f40| 72 61 72 79 20 6f 66 20 | 43 20 72 6f 75 74 69 6e |rary of |C routin|
|00001f50| 65 73 20 28 6e 6f 74 20 | 45 6c 6b 20 73 70 65 63 |es (not |Elk spec|
|00001f60| 69 66 69 63 29 0a 69 6e | 20 5a 45 4c 4b 2f 73 72 |ific).in| ZELK/sr|
|00001f70| 63 2d 7a 6c 69 62 20 77 | 68 69 63 68 20 61 72 65 |c-zlib w|hich are|
|00001f80| 20 75 73 65 64 20 62 79 | 20 74 68 65 20 65 78 74 | used by| the ext|
|00001f90| 65 6e 73 69 6f 6e 20 73 | 6f 75 72 63 65 73 2e 0a |ension s|ources..|
|00001fa0| 0a 5c 65 6e 64 7b 69 74 | 65 6d 69 7a 65 7d 0a 0a |.\end{it|emize}..|
|00001fb0| 54 68 65 6e 20 74 68 65 | 20 4d 61 6b 65 66 69 6c |Then the| Makefil|
|00001fc0| 65 20 69 6e 20 54 4f 50 | 2f 73 72 63 20 63 6f 6d |e in TOP|/src com|
|00001fd0| 70 69 6c 65 73 20 74 68 | 65 20 65 6c 6b 20 6b 65 |piles th|e elk ke|
|00001fe0| 72 6e 65 6c 20 0a 61 6e | 64 20 6c 69 6e 6b 73 20 |rnel .an|d links |
|00001ff0| 69 74 20 77 69 74 68 20 | 5a 65 6c 6b 2e 6f 20 61 |it with |Zelk.o a|
|00002000| 6e 64 20 6c 69 62 5a 2e | 61 2e 0a 54 77 6f 20 66 |nd libZ.|a..Two f|
|00002010| 69 6c 65 73 20 69 6e 20 | 54 4f 50 2f 6c 69 62 2f |iles in |TOP/lib/|
|00002020| 6d 69 73 63 20 28 75 6e | 69 78 2e 6f 20 61 6e 64 |misc (un|ix.o and|
|00002030| 20 63 68 64 69 72 2e 6f | 29 20 61 72 65 20 6e 6f | chdir.o|) are no|
|00002040| 77 20 70 72 65 2d 6c 69 | 6e 6b 65 64 0a 69 6e 20 |w pre-li|nked.in |
|00002050| 74 68 65 20 6b 65 72 6e | 65 6c 2c 20 72 61 74 68 |the kern|el, rath|
|00002060| 65 72 20 74 68 61 6e 20 | 62 65 69 6e 67 20 6c 6f |er than |being lo|
|00002070| 61 64 65 64 20 6f 6e 20 | 64 65 6d 61 6e 64 2c 20 |aded on |demand, |
|00002080| 73 69 6e 63 65 20 74 68 | 65 79 0a 61 72 65 20 75 |since th|ey.are u|
|00002090| 73 65 64 20 69 6e 20 74 | 68 65 20 60 60 65 6c 6b |sed in t|he ``elk|
|000020a0| 20 73 68 65 6c 6c 27 27 | 2e 20 20 54 68 69 73 20 | shell''|. This |
|000020b0| 69 73 20 77 68 79 20 74 | 68 65 20 6c 69 62 2f 6d |is why t|he lib/m|
|000020c0| 69 73 63 20 74 61 72 67 | 65 74 20 6d 75 73 74 20 |isc targ|et must |
|000020d0| 62 65 0a 62 65 66 6f 72 | 65 20 74 68 65 20 73 72 |be.befor|e the sr|
|000020e0| 63 2f 20 74 61 72 67 65 | 74 20 69 6e 20 74 68 65 |c/ targe|t in the|
|000020f0| 20 74 6f 70 20 6c 65 76 | 65 6c 20 4d 61 6b 65 66 | top lev|el Makef|
|00002100| 69 6c 65 2e 0a 0a 4f 6e | 20 53 47 49 20 6d 61 63 |ile...On| SGI mac|
|00002110| 68 69 6e 65 73 20 74 68 | 65 20 72 6f 75 74 69 6e |hines th|e routin|
|00002120| 65 73 20 69 6e 20 6c 69 | 62 5a 2e 61 20 75 73 75 |es in li|bZ.a usu|
|00002130| 61 6c 6c 79 20 63 61 75 | 73 65 20 0a 60 60 47 50 |ally cau|se .``GP|
|00002140| 20 72 65 6c 6f 63 61 74 | 69 6f 6e 20 65 72 72 6f | relocat|ion erro|
|00002150| 72 73 27 27 20 61 74 20 | 6c 69 6e 6b 20 74 69 6d |rs'' at |link tim|
|00002160| 65 2c 20 70 6f 73 73 69 | 62 6c 79 20 62 65 63 61 |e, possi|bly beca|
|00002170| 75 73 65 20 0a 74 68 65 | 79 20 75 73 65 20 61 20 |use .the|y use a |
|00002180| 6c 61 72 67 65 72 2d 74 | 68 61 6e 2d 6e 6f 72 6d |larger-t|han-norm|
|00002190| 61 6c 20 61 6d 6f 75 6e | 74 20 6f 66 20 67 6c 6f |al amoun|t of glo|
|000021a0| 62 61 6c 2f 73 74 61 74 | 69 63 20 73 74 6f 72 61 |bal/stat|ic stora|
|000021b0| 67 65 2e 0a 54 68 65 73 | 65 20 65 72 72 6f 72 73 |ge..Thes|e errors|
|000021c0| 20 67 6f 20 61 77 61 79 | 20 69 66 20 2a 65 76 65 | go away| if *eve|
|000021d0| 72 79 74 68 69 6e 67 2a | 20 69 73 20 63 6f 6d 70 |rything*| is comp|
|000021e0| 69 6c 65 64 20 77 69 74 | 68 20 2d 47 30 2e 0a 54 |iled wit|h -G0..T|
|000021f0| 68 65 20 70 72 6f 70 65 | 72 20 2d 47 20 76 61 6c |he prope|r -G val|
|00002200| 75 65 20 28 6f 74 68 65 | 72 20 74 68 61 6e 20 30 |ue (othe|r than 0|
|00002210| 29 20 69 73 20 6e 6f 74 | 20 6b 6e 6f 77 6e 20 74 |) is not| known t|
|00002220| 6f 20 6d 65 2e 0a 0a 54 | 68 65 20 73 70 61 72 63 |o me...T|he sparc|
|00002230| 20 66 6f 72 65 69 67 6e | 20 66 75 6e 63 74 69 6f | foreign| functio|
|00002240| 6e 20 69 6e 74 65 72 66 | 61 63 65 20 69 6e 20 66 |n interf|ace in f|
|00002250| 6f 72 66 75 6e 63 2e 63 | 20 6d 75 73 74 20 0a 6e |orfunc.c| must .n|
|00002260| 6f 74 20 62 65 20 63 6f | 6d 70 69 6c 65 64 20 77 |ot be co|mpiled w|
|00002270| 69 74 68 20 2d 4f 2c 20 | 73 69 6e 63 65 20 6f 70 |ith -O, |since op|
|00002280| 74 69 6d 69 7a 61 74 69 | 6f 6e 20 77 69 6c 6c 20 |timizati|on will |
|00002290| 67 65 6e 65 72 61 74 65 | 0a 69 6e 63 6f 72 72 65 |generate|.incorre|
|000022a0| 63 74 20 63 6f 64 65 20 | 69 6e 20 70 72 6f 67 72 |ct code |in progr|
|000022b0| 61 6d 73 20 77 69 74 68 | 20 61 73 6d 28 29 20 73 |ams with| asm() s|
|000022c0| 74 61 74 65 6d 65 6e 74 | 73 2e 0a 0a 5c 73 75 62 |tatement|s...\sub|
|000022d0| 73 65 63 74 69 6f 6e 2a | 7b 43 6f 64 69 6e 67 7d |section*|{Coding}|
|000022e0| 0a 4d 6f 64 69 66 69 63 | 61 74 69 6f 6e 73 20 74 |.Modific|ations t|
|000022f0| 6f 20 74 68 65 20 6f 72 | 69 67 69 6e 61 6c 20 45 |o the or|iginal E|
|00002300| 6c 6b 20 73 6f 75 72 63 | 65 20 61 72 65 20 66 6c |lk sourc|e are fl|
|00002310| 61 67 67 65 64 20 62 79 | 20 61 6e 20 0a 5c 23 69 |agged by| an .\#i|
|00002320| 66 20 61 6e 64 20 63 6f | 6d 6d 65 6e 74 20 69 6e |f and co|mment in|
|00002330| 20 74 68 65 20 73 6f 75 | 72 63 65 2d 0a 5c 62 65 | the sou|rce-.\be|
|00002340| 67 69 6e 7b 76 65 72 62 | 61 74 69 6d 7d 0a 20 20 |gin{verb|atim}. |
|00002350| 20 20 20 20 20 20 23 69 | 66 20 5a 45 4c 4b 20 0a | #i|f ZELK .|
|00002360| 20 20 20 20 20 20 20 20 | 2e 2e 2e 2e 20 2f 2a 26 | |.... /*&|
|00002370| 7a 69 6c 6c 61 2e 2e 2e | 2a 2f 0a 5c 65 6e 64 7b |zilla...|*/.\end{|
|00002380| 76 65 72 62 61 74 69 6d | 7d 0a 43 6f 6d 70 69 6c |verbatim|}.Compil|
|00002390| 69 6e 67 20 77 69 74 68 | 20 5a 45 4c 4b 20 74 75 |ing with| ZELK tu|
|000023a0| 72 6e 65 64 20 6f 66 66 | 20 68 61 73 20 6e 6f 74 |rned off| has not|
|000023b0| 20 66 75 6c 6c 79 20 74 | 65 73 74 65 64 2e 0a 0a | fully t|ested...|
|000023c0| 54 68 65 20 65 78 74 65 | 6e 73 69 6f 6e 20 73 6f |The exte|nsion so|
|000023d0| 75 72 63 65 20 66 69 6c | 65 73 20 69 6e 63 6c 75 |urce fil|es inclu|
|000023e0| 64 65 20 61 20 66 69 6c | 65 20 74 68 65 75 73 75 |de a fil|e theusu|
|000023f0| 61 6c 2e 68 2e 0a 49 20 | 61 74 74 65 6d 70 74 65 |al.h..I |attempte|
|00002400| 64 20 74 6f 20 6d 6f 76 | 65 20 61 6c 6c 20 6d 65 |d to mov|e all me|
|00002410| 73 73 79 20 6e 6f 6e 2d | 70 6f 72 74 61 62 6c 65 |ssy non-|portable|
|00002420| 20 43 20 64 65 74 61 69 | 6c 73 20 69 6e 74 6f 20 | C detai|ls into |
|00002430| 74 68 69 73 20 66 69 6c | 65 3b 0a 74 68 65 20 73 |this fil|e;.the s|
|00002440| 6f 75 72 63 65 20 69 74 | 73 65 6c 66 20 68 61 73 |ource it|self has|
|00002450| 20 66 65 77 65 72 20 5c | 23 69 66 64 65 66 73 20 | fewer \|#ifdefs |
|00002460| 61 73 20 61 20 72 65 73 | 75 6c 74 2c 20 0a 62 75 |as a res|ult, .bu|
|00002470| 74 20 74 68 69 73 20 66 | 69 6c 65 20 69 73 20 61 |t this f|ile is a|
|00002480| 20 6d 65 73 73 2e 20 20 | 59 6f 75 20 6d 61 79 20 | mess. |You may |
|00002490| 6e 65 65 64 20 74 6f 20 | 63 68 61 6e 67 65 20 73 |need to |change s|
|000024a0| 6f 6d 65 20 6f 66 20 69 | 74 2e 0a 0a 54 68 65 20 |ome of i|t...The |
|000024b0| 65 78 74 65 6e 73 69 6f | 6e 20 73 6f 75 72 63 65 |extensio|n source|
|000024c0| 73 20 75 73 65 20 73 65 | 76 65 72 61 6c 20 6d 61 |s use se|veral ma|
|000024d0| 63 72 6f 73 20 66 72 6f | 6d 20 74 68 65 75 73 75 |cros fro|m theusu|
|000024e0| 61 6c 2e 68 2e 0a 54 68 | 65 20 6d 61 63 72 6f 20 |al.h..Th|e macro |
|000024f0| 5a 70 72 6f 74 6f 28 28 | 70 72 6f 74 6f 74 79 70 |Zproto((|prototyp|
|00002500| 65 29 29 20 61 70 70 65 | 61 72 73 20 69 6e 20 66 |e)) appe|ars in f|
|00002510| 75 6e 63 74 69 6f 6e 20 | 70 72 6f 74 6f 74 79 70 |unction |prototyp|
|00002520| 65 73 3b 0a 69 74 20 69 | 73 20 74 68 65 20 73 61 |es;.it i|s the sa|
|00002530| 6d 65 20 61 73 20 74 68 | 65 20 50 5c 5f 20 6d 61 |me as th|e P\_ ma|
|00002540| 63 72 6f 20 69 6e 20 74 | 68 65 20 45 6c 6b 20 6b |cro in t|he Elk k|
|00002550| 65 72 6e 65 6c 20 73 6f | 75 72 63 65 73 2e 0a 49 |ernel so|urces..I|
|00002560| 6e 20 41 4e 53 49 20 43 | 20 69 74 20 65 78 70 61 |n ANSI C| it expa|
|00002570| 6e 64 73 20 69 6e 74 6f | 20 28 70 72 6f 74 6f 74 |nds into| (protot|
|00002580| 79 70 65 29 3b 20 69 6e | 20 4b 5c 26 52 20 43 20 |ype); in| K\&R C |
|00002590| 69 74 20 65 78 70 61 6e | 64 73 20 69 6e 74 6f 20 |it expan|ds into |
|000025a0| 28 29 2e 0a 54 68 65 20 | 6d 61 63 72 6f 20 5a 74 |()..The |macro Zt|
|000025b0| 72 61 63 65 28 28 70 72 | 69 6e 74 66 2d 61 72 67 |race((pr|intf-arg|
|000025c0| 73 29 29 20 65 78 70 61 | 6e 64 73 20 69 6e 74 6f |s)) expa|nds into|
|000025d0| 20 70 72 69 6e 74 66 28 | 70 72 69 6e 74 66 2d 61 | printf(|printf-a|
|000025e0| 72 67 73 29 20 69 66 0a | 5c 62 65 67 69 6e 7b 76 |rgs) if.|\begin{v|
|000025f0| 65 72 62 61 74 69 6d 7d | 0a 20 20 20 20 20 20 20 |erbatim}|. |
|00002600| 20 23 64 65 66 69 6e 65 | 20 7a 74 72 61 63 65 0a | #define| ztrace.|
|00002610| 5c 65 6e 64 7b 76 65 72 | 62 61 74 69 6d 7d 0a 61 |\end{ver|batim}.a|
|00002620| 70 70 65 61 72 73 20 62 | 65 66 6f 72 65 20 74 68 |ppears b|efore th|
|00002630| 65 75 73 75 61 6c 2e 68 | 20 6f 72 20 7a 65 6c 6b |eusual.h| or zelk|
|00002640| 2e 68 20 69 73 20 69 6e | 63 6c 75 64 65 64 2e 0a |.h is in|cluded..|
|00002650| 0a 54 68 65 20 64 65 66 | 69 6e 65 20 5a 49 4c 4c |.The def|ine ZILL|
|00002660| 41 4f 4e 4c 59 20 61 70 | 70 65 61 72 73 20 69 6e |AONLY ap|pears in|
|00002670| 20 7a 65 6c 6b 2e 68 3b | 20 74 68 69 73 20 62 72 | zelk.h;| this br|
|00002680| 61 63 6b 65 74 73 20 61 | 20 66 65 77 20 74 68 69 |ackets a| few thi|
|00002690| 6e 67 73 0a 77 68 69 63 | 68 20 61 72 65 20 73 70 |ngs.whic|h are sp|
|000026a0| 65 63 69 66 69 63 20 74 | 6f 20 74 68 65 20 61 75 |ecific t|o the au|
|000026b0| 74 68 6f 72 27 73 20 69 | 6e 73 74 61 6c 6c 61 74 |thor's i|nstallat|
|000026c0| 69 6f 6e 20 61 6e 64 20 | 61 72 65 0a 6e 6f 74 20 |ion and |are.not |
|000026d0| 6f 66 20 67 65 6e 65 72 | 61 6c 20 69 6e 74 65 72 |of gener|al inter|
|000026e0| 65 73 74 2e 0a 0a 5c 65 | 6e 64 7b 64 6f 63 75 6d |est...\e|nd{docum|
|000026f0| 65 6e 74 7d 0a | |ent}. | |
+--------+-------------------------+-------------------------+--------+--------+